# Q. What is this file?
# A. This file contains options which allow you to configure your multiworld experience while allowing
#    others to play how they want as well.
#
# Q. How do I use it?
# A. The options in this file are weighted. This means the higher number you assign to a value, the
#    more chances you have for that option to be chosen. For example, an option like this:
#
#    map_shuffle:
#      on: 5
#      off: 15
#
#    Means you have 5 chances for map shuffle to occur, and 15 chances for map shuffle to be turned
#    off.
#
# Q. I've never seen a file like this before. What characters am I allowed to use?
# A. This is a .yaml file. You are allowed to use most characters.
#    To test if your yaml is valid or not, you can use this website:
#        http://www.yamllint.com/
#    You can also verify that your Archipelago options are valid at this site:
#        https://archipelago.gg/check

# Your name in-game, limited to 16 characters.
#     {player} will be replaced with the player's slot number.
#     {PLAYER} will be replaced with the player's slot number, if that slot number is greater than 1.
#     {number} will be replaced with the counter value of the name.
#     {NUMBER} will be replaced with the counter value of the name, if the counter value is greater than 1.
name: Player{number}

# Used to describe your yaml. Useful if you have multiple files.
description: Default Wario Land 3 Template

game: Wario Land 3
requires:
  version: 0.6.7 # Version of Archipelago required for this yaml to work as expected.

Wario Land 3:
  ################
  # Game Options #
  ################
  progression_balancing:
    # A system that can move progression earlier, to try and prevent the player from getting stuck and bored early.
    # 
    # A lower setting means more getting stuck. A higher setting means less getting stuck.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 99
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-99: 0 # random value between 0 and 99
    disabled: 0 # equivalent to 0
    normal: 50 # equivalent to 50
    extreme: 0 # equivalent to 99

  accessibility:
    # Set rules for reachability of your items/locations.
    # 
    # **Full:** ensure everything can be reached and acquired.
    # 
    # **Minimal:** ensure what is needed to reach your goal can be acquired.
    full: 50
    minimal: 0

  difficulty:
    # Sets whether knowledge checks and/or hard tricks may be required in logic.
    # Standard: Requires no extra knowledge besides what is used to beat the vanilla game.
    # Knowledge Checks: Requires the player to know basic shortcuts, 
    # such as breaking hidden blocks in walls.
    # Hard Tricks: Everything from "knowledge checks", and also may require the player to 
    # perform more difficult tricks, such as jumping off of a thrown enemy in midair.
    standard: 50
    knowledge_checks: 0
    hard_tricks: 0

  minor_glitches:
    # Sets whether minor glitches may be required in logic.
    # Easy glitches: Simple glitches such as water walking or block clipping with flat form.
    # All glitches: Everything from easy glitches as well as things like wall jumps and screen wrapping.
    none: 50
    easy_glitches: 0
    all_glitches: 0

  start_with_axe:
    # Start with the Axe, immediately unlocking The Peaceful Village and The Vast Plain.
    'false': 0
    'true': 50

  random_level_starts:
    # Start with this many additional randomly chosen level unlock items beyond Out of the Woods.
    # 0: off (default)
    # 1-8: that many random level unlock groups are granted at the start.
    # Stacks with Start with Axe (Axe is never included in the random pool).
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 8
    0: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-8: 0 # random value between 0 and 8

  combined_items:
    # Controls which multi-item requirements are combined into single items.
    # Off:       No combining; multi-item requirements stay as-is.
    # Overworld: Combine items that gate level access (e.g. Blue+Green Tablet → Tablets).
    # In Level:  Combine items that gate chests/keys within a level (e.g. Blue+Red Chemical → Chemicals).
    # Both:      Combine both overworld and in-level pairs.
    'off': 50
    overworld: 0
    in_level: 0
    both: 0

  key_shuffle:
    # Controls how the 100 level keys (4 per level × 25 levels) are handled.
    # Vanilla: Each key location is vanilla
    # Full: Keys and treasures are shuffled together across all 200 locations. (This adds 100 checks)
    vanilla: 50
    full: 0

  keyring_count:
    # Number of levels whose 4 keys are replaced by a single Keyring item.
    # 0 = off (each key is its own item).
    # 1-24 = that many randomly-chosen levels get a Keyring (the other levels keep individual keys).
    # 25 = every level gets a Keyring (no individual key items in the pool).
    # When above 0, Key Shuffle is forced to Full so that the remaining individual
    # keys are still shuffled.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 25
    0: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-25: 0 # random value between 0 and 25

  transformation_shuffle:
    # Shuffle transformation abilities (Zombie, Vampire, Fire, etc.) as items.
    # When on, you must find each Form item to use that transformation via
    # Select+button combos; the forms are placed in logic. When off, behaves as vanilla
    'false': 50
    'true': 0

  music_boxes_required:
    # How many of the 5 music boxes Wario must collect before
    # the Temple opens and the final boss becomes accessible.
    # Set to 0 to make the Temple always open.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 5
    5: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-5: 0 # random value between 0 and 5

  music_box_shuffle:
    # Controls where the 5 music boxes can be placed.
    # Any Boss: music boxes can be placed at any of the 10 boss chest locations.
    # Anywhere: music boxes can be placed anywhere in the multiworld (default).
    any_boss: 0
    anywhere: 50

  bigcoinsanity:
    # Adds 200 big-coin (musical coin) locations  — 8 per level — to the pool.
    'false': 50
    'true': 0

  death_link:
    # Send and receive deaths to/from other players. This will trigger the "Game Over" screen when you die, forcing you to restart the level. If Death Mode is set to "Grabs" or "Grabs and Golf", then certain enemy grabs or golf failures will also trigger deaths. You can still receive deaths from other players even if your own Death Mode is set to None.
    # screen from being captured by Rudy. You can include "Death Mode" below to add more
    # death link options locally.
    'false': 50
    'true': 0

  death_mode:
    # Controls what locally counts as a death. 
    # None: deaths are never triggered locally; you can still receive deaths
    # from other players if Death Link is on.
    # Grabs: enemy grabs that teleport you  (e.g. RoboMouse, Scowler, Rudy) 
    # instead trigger a Game Over death.
    # Grabs and Golf: same as Grabs, plus failing a golf hole par triggers a death
    none: 50
    grabs: 0
    grabs_and_golf: 0

  ###################
  # Quality of Life #
  ###################
  golf_price:
    # Sets the coin cost for the mini-games (golf). 
    # Vanilla: Tier-based cost (10 / 30 / 50 coins).
    # Free: FREE GOLF!
    # Cheap: Reduced tier-based cost (5 / 10 / 15 coins).
    # The Golf Building courses are always free regardless of this setting.
    vanilla: 0
    free: 50
    cheap: 0

  golf_building:
    # Controls whether the Golf Building is always open or requires crayons to open.
    # Open: Golf Building can always be entered (always free to play).
    # Vanilla: the Golf Building requires all 7 crayons to open (vanilla behavior).
    open: 50
    vanilla: 0

  i_hate_golf:
    # Automatically win the golf mini-game as soon as it starts.
    # The hole is immediately cleared without having to play.
    # Does not work correctly with the Golf Building
    'false': 50
    'true': 0

  start_with_magnifying_glass:
    # Start with the Magnifying Glass, which shows what treasures/chests have been collected
    # in the overworld map (Press B while hovering a level).
    'false': 0
    'true': 50

  reduce_flashing:
    # Disables flashing/blinking background palette cycling in certain rooms
    # (e.g. underground areas, Warped Void). Recommended for photosensitivity.
    # This option is automatically on if any palette shuffle is active, since palette 
    # cycling can be very visually jarring when combined with random palettes.
    'false': 50
    'true': 0

  non_stop_chests:
    # Stay in the level after opening a treasure chest instead of exiting to
    # the overworld.
    'false': 50
    'true': 0

  trap_fill:
    # Percentage of filler items replaced with transformation traps.
    # When a trap is received, Wario is set on fire the next safe frame.
    # 0 = no traps (default), 100 = every filler item is a trap.
    #
    # You can define additional values between the minimum and maximum values.
    # Minimum value is 0
    # Maximum value is 100
    0: 50
    random: 0
    random-low: 0 # random value weighted towards lower values
    random-high: 0 # random value weighted towards higher values
    random-range-0-100: 0 # random value between 0 and 100

  #############
  # Cosmetics #
  #############
  music_shuffle:
    # Randomize the background music played in each level.
    # Split: Day and night music are shuffled within their own groups (day with day, night with night).
    # Full:  All music tracks are fully randomized regardless of day/night.
    vanilla: 50
    split: 0
    full: 0

  enemy_palette_shuffle:
    # Randomize enemy sprite palettes.
    'false': 50
    'true': 0

  level_bg_palette_shuffle:
    # Randomize level/room background (BG) palettes.
    # Off: no changes
    # Simple: Changes palettes slightly less aggressively
    # Full: Fully randomizes background palettes without restrictions
    'off': 50
    simple: 0
    full: 0

  wario_overalls_shuffle:
    # Randomize Wario's overalls/outline color. (This will affect some other in-game colors)
    'false': 50
    'true': 0

  wario_shirt_shuffle:
    # Randomize Wario's shirt/highlight color. (This affects all the white of Wario, including his hat and eyes)
    'false': 50
    'true': 0

  ###########################
  # Item & Location Options #
  ###########################
  local_items:
    # Forces these items to be in their native world.
    []

  non_local_items:
    # Forces these items to be outside their native world.
    []

  start_inventory:
    # Start with the specified amount of these items. Example: "Bomb: 1"
    {}

  start_hints:
    # Start with these item's locations prefilled into the ``!hint`` command.
    []

  start_location_hints:
    # Start with these locations and their item prefilled into the ``!hint`` command.
    []

  exclude_locations:
    # Prevent these locations from having an important item.
    []

  priority_locations:
    # Prevent these locations from having an unimportant item.
    []

  item_links:
    # Share part of your item pool with other players.
    []

  plando_items:
    # Generic items plando.
    []
